Tranzakció típusok

A start művelet során beküldött paymentMethods tömbben lévő érték fogja meghatározni, milyen tranzakció fog elindulni az Online Fizetési Oldalon. Jelenleg egyszerre csak 1 tranzakciót lehet indítani 1 start hívással, azaz egyelőre csak egy elemű lehet a tömb.

Értékkészlet:

EAM (Egységes adatbeviteli megoldás tranzakció indítás)
RTP (Fizetési kérelem indítás)

Fontos különbség még, hogy a kérésben szerepelő mező validáció ettől az értéktől függ. EAM paymentMethod esetén kötelező a terminalReference nevű mező, míg RTP esetén kötelező a debtorName, illetve EAM esetén url enkódolás után kell nézni egyes mezők hosszát, míg RTP esetén egyszerű karakterhosszként kell mérni.

Mezők:

idempotencyKey: minden esetben kötelező, UUID
technicalUserId: minden esetben kötelező, String
language: minden esetben kötelező, enum
url: minden esetben kötelező: String
transactionReference: minden esetben kötelező
EAM esetén: hossz: 1-17 url enkódolás után, regex:
RTP esetén: hossz: 1-17 karakterhossz, regex:

Példa EAM tranzakció indításhoz (start)

{ 
   technicalUserId: " 10234", 
   language: "HU", 
   url: " https://demo-webshop.hu", 
   transactionReference: "1Ffnhelta3b", 
   paymentMethods: [ 
     "EAM" 
      ], 
   transactionCurrency: "HUF", 
   transactionAmount: 250, 
   remittanceInfo: " Teszt vásárlás", 
   shopId: "shop0001", 
   terminalReference: "terminal0001", 
   timestamp: "2024-10-04T14:23:45Z", 
   idempotencyKey: "f4e5b92d-60ff-46bd-a26a-8342116cdec5" 
}

Fontos eltérések

A mezőhosszokat url enkódolás után kell mérni. A terminalReference EAM specifikus mező.

Példa RTP tranzakció indításhoz (start)

{
   technicalUserId: " 10234", 
   language: "HU", 
   url: " https://demo-webshop.hu", 
   transactionReference: "1Ffnhelta3b", 
   paymentMethods: [ 
     "RTP" 
      ], 
   transactionCurrency: "HUF", 
   transactionAmount: 250, 
   remittanceInfo: " Teszt vásárlás", 
   shopId: "shop0001", 
   debtorName: "Kovács Béla”,
   timestamp: "2024-10-04T14:23:45Z", 
   idempotencyKey: "f4e5b92d-60ff-46bd-a26a-8342116cdec5" 
}

Fontos eltérések

A mezőhosszokat egyszerű karakterhosszúságként kell mérni. A debtorName RTP specifikus mező.